PaintPoly

PaintPoly
Header:	Quickdraw.h		Carbon status:	Supported

Paints a polygon with the graphics pen’s pattern and pattern mode.

void PaintPoly (
    PolyHandle poly
);

Parameter descriptions

poly: A handle to the polygon to paint. The OpenPoly function returns this handle when you first create the polygon.

DISCUSSION

Using the pen pattern and pattern mode for the current graphics port, the PaintPoly function draws the interior of a polygon whose handle you pass in the poly parameter. The pen location does not change.

This function temporarily converts the polygon into a region to perform their operations. The amount of memory required for this temporary region may be far greater than the amount required by the polygon alone.

You can estimate the size of this region by scaling down the polygon with the MapPoly, converting the polygon into a region, checking the region’s size with the Memory Manager function GetHandleSize, and multiplying that value by the factor by which you scaled the polygon.

The result of this graphics operation is undefined whenever any horizontal or vertical line drawn through the polygon would intersect the polygon’s outline more than 50 times.

Use the FillPoly function to draw the interior of a polygon with a pattern different from that specified in the pnPat field of the current graphics port.

SPECIAL CONSIDERATIONS

Do not create a height or width for the polygon greater than 32,767 pixels, or PaintPoly will crash.

The PaintPoly function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.